next up previous contents
Next: About this document Up: Command Keys Previous: Tips

Double-clicking

  The arguments of certain LaTeX commands are command-double-clickable, that is, you hold down the <CMD> key while double-clicking the argument of certain LaTeX commands. These commands are underlined and therefore easily recognized in your document. When you command-double-click the required argument of a \ref command, for example, the cursor jumps to the corresponding \label. (Note: Press <CTL .> to return to the original cursor position.) Similarly, when you cmd-dbl-click the required argument of a \cite command, the cursor jumps to the corresponding \bibitem if the document contains a thebibliography environment; otherwise, the arguments of a \bibliography command are sequentially searched until the .bib file containing the target item is found. This .bib file is then opened and the cursor jumps to the target item.

Tip: By default, \ref, \pageref, \cite, and \nocite commands are cmd-dbl-clickable. If you use a package that defines other \ref-like or \cite-like commands, modify the TeX mode variables refCommands or citeCommands discussed in section 1.4.2.

Other LaTeX commands may also be command-double-clicked, for example, \input, \include, \includegraphics (or rather the commands specified in the TeX mode variable boxMacroNames mentioned in section 1.4.2), \bibliography, \usepackage, and \documentclass. Note that the required arguments of these commands are files, and so command-double-clicking such an argument opens the corresponding file. Unless the filename includes a Macintosh path (which is not recommended, since it's not portable), the current folder is searched first. If the file is not found in the current folder, the algorithm next checks the hierarchy of folders under the user-specified ``TeX Inputs Folder'', which is optionally set by choosing App Paths on the Config menu. If the file is still not found, all folders whose name contains the string ``inputs'' in the TeX application folder are checked next. For example, all folders in the TeX folder with names such as TeX-inputs, TeX-inputs2, and My-TeX-inputs will be searched.

Tip: A command-double-click operation may be simulated with a keystroke. With the cursor inside the required argument of a cmd-dbl-clickable LaTeX command, press <F6> to activate the algorithm.

Alpha has another modified double-click that will be of interest to LaTeX users. You may already know that double-clicking a delimiter (parenthesis, bracket, or brace) selects the text between it and its matching delimiter. Moreover, if you hold down the <CTL> key while double-clicking a delimiter, the text and the delimiters will be selected. These commands are very handy for cutting and pasting blocks of delimited text, especially in a LaTeX document where braces, for example, run rampant.


next up previous contents
Next: About this document Up: Command Keys Previous: Tips

Tom Scavo
Sun Sep 1 11:50:47 EDT 1996